home *** CD-ROM | disk | FTP | other *** search
/ Storm 1 / Storm I.iso / x34 / casino.arc / CASINO.DOC < prev    next >
Text File  |  1989-02-02  |  12KB  |  320 lines
  1.  
  2. File list:
  3. ==========
  4.  
  5. This document is a simple instruction to use to setup The Mycroft Casino
  6. for your RBBS.  The following files are included:
  7.  
  8.           CASINO.DOC   -  SysOp documentation (this document)
  9.           CASINO.BAT   -  DOORS execution file (sample)
  10.           CASINO.EXE   -  The executible program (will run stand-alone)
  11.           CSINIT.EXE   -  The initialization program (restarts a game)
  12.           CSINFO.DAT   -  Update data (created by program)
  13.           CSPLAYER.DAT -  Update data (created by program)
  14.           CASINO.NEW   -  Message for new players
  15.           CASINO.BUL   -  Bulletin file name
  16.           NODES.BBS    -  A list of your comm port assignments by BBS node
  17.  
  18.           TIMEGEN.EXE  -  Time control file generator
  19.           TIMES.DEF    -  Sample time control file
  20.           CASINO.TIM   -  Compiled time controls (created by timegen)
  21.  
  22.  
  23. Program history:
  24. ================
  25.  
  26. 1/89    Version 1.00  -  First version.
  27. 2/89    Version 1.01  -  Fix to PCBoard 14.0 interface
  28.                          Replaced all references to credits with dollars.
  29.  
  30.  
  31. Executing Casino:
  32. =================
  33.  
  34. To execute directly as a door, you can use the file CASINO.BAT.  The
  35. program must be executed from the directory containing all of the
  36. above listed files except that NODES.BBS must be in the RBBS directory.
  37.  
  38. Casino is invoked on of five ways.
  39.  
  40.         1. CASINO
  41.         2. CASINO node
  42.         3. CASINO node path
  43.         4. CASINO node path bbs
  44.         5. CASINO MAINTENANCE
  45.  
  46. The first is used to run Casino in local mode.  This will play as any
  47. other game on your IBM PC.  The second method is used to run Casino
  48. under the door monitor.  The node parameter is automatically supplied by
  49. the door monitor itself.  The third method is used when running as a
  50. door under RBBS 15.  The path parameter is the current full path containing
  51. the RBBS configuration files.  The node is the RBBS node number.  The
  52. node number is passed to door batch files as parameter 1.  The fourth
  53. method may be used for a variety of BBSs.  The fourth parameter is
  54. used to specify the BBS type.  Set this to:
  55.  
  56.         (empty)         for RBBS 15.x
  57.         RBBS            for RBBS 16.x
  58.         QBBS            for Quick BBS
  59.         PCBOARD         for PC-Board BBS 12.1
  60.         PCBOARD14       for PC-Board BBS 14.0
  61.         WILDCAT         for Wildcat BBS
  62.         GAP             for GAP BBS
  63.         WWIV            for WWIV BBS
  64.  
  65.  
  66. Assumed RBBS 16.x files:
  67. ========================
  68.  
  69. Casino assumes that the following files are in the directory specified
  70. by the path parameter when running directly under RBBS 16.x:
  71.  
  72.         NODES.BBS       Node definition file.
  73.  
  74.         MESSAGES        This file contains the information pertaining
  75.                         to each node on the BBS.
  76.  
  77.         DORINFOx.DEF    This file contains all of the users settings
  78.                         such as graphics, parity, baud rate, etc.
  79.  
  80.  
  81. Assumed RBBS 15.x files:
  82. ========================
  83.  
  84. Casino assumes that the following files are in the directory specified
  85. by the path parameter when running directly under RBBS 15.x:
  86.  
  87.         NODES.BBS       Node definition file.
  88.  
  89.         MESSAGES        This file contains the information pertaining
  90.                         to each node on the BBS.
  91.  
  92.         USERS           This file contains all of the users settings
  93.                         such as graphics, parity, baud rate, etc.
  94.  
  95.         PASSWRDS        This file MUST contain an entry for each security
  96.                         level allowed to run doors.  Market gets the
  97.                         users daily time limit from this file.
  98.  
  99.  
  100. Assumed Quick BBS files:
  101. ========================
  102.  
  103. Casino assumes that the following files are in the directory specified
  104. by the path parameter when running directly under Quick BBS:
  105.  
  106.         NODES.BBS       Node definition file.
  107.  
  108.         DORINFOx.DEF    This file contains all of the users settings
  109.                         such as graphics, parity, baud rate, etc.
  110.  
  111.  
  112. Assumed PC-BOARD files:
  113. =======================
  114.  
  115. Casino assumes that the following files are in the directory specified
  116. by the path parameter when running directly under PC-Board:
  117.  
  118.         NODES.BBS       Node definition file.
  119.  
  120.         PCBOARD.SYS     This file contains the information pertaining
  121.                         to the BBS node and the callers information.
  122.  
  123.  
  124.  
  125. Assumed Wildcat files:
  126. ======================
  127.  
  128. Casino assumes that the following files are in the directory specified
  129. by the path parameter when running directly under Wildcat:
  130.  
  131.         NODES.BBS       Node definition file.
  132.  
  133.         CALLINFO.BBS    This file contains all of the users settings
  134.                         such as graphics, parity, baud rate, etc.
  135.  
  136.  
  137.  
  138. Assumed GAP files:
  139. ==================
  140.  
  141. Casino assumes that the following files are in the directory specified
  142. by the path parameter when running directly under GAP BBS:
  143.  
  144.         NODES.BBS       Node definition file.
  145.  
  146.         DOOR.SYS        This file contains all of the users settings
  147.                         such as graphics, parity, baud rate, etc.
  148.  
  149.  
  150.  
  151. Assumed WWIV files:
  152. ===================
  153.  
  154. Casino assumes that the following files are in the directory specified
  155. by the path parameter when running directly under WWIV BBS:
  156.  
  157.         NODES.BBS       Node definition file.
  158.  
  159.         CHAIN.TXT       This file contains all of the users settings
  160.                         such as graphics, parity, baud rate, etc.
  161.  
  162.  
  163.  
  164. Assumed Monitor files:
  165. ======================
  166.  
  167. Casino assumes that the following files are in the local directory with
  168. the game when running under an RBBS monitor:
  169.  
  170.         NODES.BBS       Node definition file.
  171.  
  172.         TIMEOFFx.DOR    This file contains all of the users settings
  173.                         such as graphics, parity, baud rate, etc.
  174.  
  175.  
  176. Casino assumes that the following files are in directory specified in the
  177. path parameter of the TIMEOFFx.DOR file:
  178.  
  179.         USERS.DOR       Monitor users file.
  180.  
  181.         MONITOR1.EXE    This file will be executed when the program
  182.                         terminates.
  183.  
  184.  
  185. Casino will build the following files are in the local directory with
  186. the game when running under an RBBS monitor:
  187.  
  188.         POINTSx.DOR     This file contains returns the amount of time
  189.                         used in the game and a Monitor score value.
  190.  
  191.  
  192.  
  193. Adding time controls:
  194. =====================
  195.  
  196. Casino contains the ability to control access of the game by security level,
  197. time of day, total play time per day, total play time per game, total game
  198. count per day, and time required to wait in between games.
  199.  
  200. The time control file may be used directly under a BBS or also with the door
  201. monitor.  If not included, then only the standard time controls are used.
  202.  
  203. The time definition file is an ASCII file used to create the time control
  204. data file.  It has the following format:
  205.  
  206. :SYSOP 1000 2330                                         ; Sysops hours
  207. :LEVEL  006  007  008  008  008  008  008  008           ; Level access classes
  208. :DAYT   000  000  000  000  000  000  000  000           ; Daily time limits
  209. :DAYG   001  002  003  003  003  003  003  003           ; Daily game limits
  210. :WAIT   000  030  030  000  000  000  000  000           ; Time between games
  211. :TIME  0000  060  060  060  060  060  060  060  120      ; Per game access
  212. :TIME  0600  000  030  030  030  030  030  030  030      ; Per game access
  213. :TIME  1000  000  045  045  045  045  045  045  120      ; Per game access
  214. :TIME  1600  000  030  030  030  030  030  030  030      ; Per game access
  215. :TIME  2000  000  045  045  045  045  045  045  060      ; Per game access
  216.  
  217. The first entry defines the SysOp hours.  This controls when the player may
  218. use the page command.  These entires are expressed as HHMM.  The second entry
  219. may be smaller than the first.  As an example, ":SYSOP 0700 1900" allows the
  220. player to use the page command from 7am until 7pm.  The entry ":SYSOP 2200
  221. 0200" allows the page command to be used between 10pm and 2am.
  222.  
  223. The ":LEVEL" entry defines how different security level users have access to
  224. the game.  This line consists of 8 entries in ascending order.  Each entry
  225. corresponds to a game control level.  As an example let us consider the
  226. following entry: ":LEVEL 010 020 030 040 050 060 070 080".  Any user with
  227. a security level of less than 10 would not have access to the game.  Users
  228. with security level 10 through 19 would have level 0 privelidges.  Users
  229. with security level 20 through 29 would have level 1 privelidges, etc.
  230. Priveledges are explained below.
  231.  
  232. The ":DAYT" entry defines the maximum time in minutes each privelidge level
  233. may play the game per day.  This entry consists of 8 values each corresponding
  234. to a privelidge level in ascending order.  Each value is in minutes.  A value
  235. of 0 represents no daily time limit for that particular privelidge level.
  236.  
  237. The ":DAYG" entry defines the maximum number of times the user may enter the
  238. game on a gien day.  It consists of 8 values each corresponding to a
  239. privelidge level in ascending order.  A value of 0 represents no game limit
  240. for that particular privelidge level.
  241.  
  242. The ":WAIT" entry defines the amount of time in minutes each user must
  243. wait between entering the game.  This entry consists of 8 values each
  244. corresponding to a privelidge level in ascending order.
  245.  
  246. The ":TIME" entries define the amount of time each user may spend during a
  247. single play session.  It consists of 9 values.  The first is the time of
  248. day the period starts.  The remaining 8 are the game time limits for
  249. each of the 8 privelidge levels.  Time limits are in minutes.  A 0 value
  250. here means that the user my not play the game during that time period.
  251. Each ":TIME" entry must be in ascending time of day order.  There may be
  252. a maximum of 8 ":TIME" entries.
  253.  
  254. To build the time control file, the following command line is used:
  255.  
  256.                 TIMEGEN def_file time_file
  257.  
  258. Where def_file is the ASCII file defining all time controls and time_file
  259. is the output file that the game will read.  For Casino, use the following
  260. command line:
  261.  
  262.                 TIMEGEN times.def casino.tim
  263.  
  264.  
  265. Deleting old players:
  266. =====================
  267.  
  268. Old players are automatically deleted by Casino after 30 days of inactivity.
  269.  
  270.  
  271. SysOp controls:
  272. ===============
  273.  
  274. The SysOp has similar controls as to those provided in RBBS.  The following
  275. set of functions are available:
  276.  
  277.     Alt F1      This key will eject a user from the game by
  278.                 setting all his time to consumed.
  279.  
  280.     Right Arrow This key will add one minute of game time to
  281.                 the current users current game session.
  282.  
  283.     Left Arrow  This key will subtract one minute of game time
  284.                 from the current users current game session.
  285.  
  286.         F4      The F4 key will toggle the state of the SysOp
  287.                 annoy toggle.  Note that it is reset to its
  288.                 original state when RBBS is reentered.
  289.  
  290.         F6      The F6 key will toggle the state of the SysOp
  291.                 availability toggle.  Note that it is reset to
  292.                 its original state when RBBS is reentered.
  293.  
  294.         F9      The F9 key will toggle the state of the SysOp
  295.                 snoop toggle.  Note that it is reset to its
  296.                 original state when RBBS is reentered.
  297.  
  298.         F10     The F10 key is used to initiate CHAT mode.  This
  299.                 allows the SysOp to converse with the user via the
  300.                 keyboard.  Unlike RBBS, CHAT mode in Market does
  301.                 not support word wrap and you will need to hit the
  302.                 ENTER key ate the end of each line.
  303.  
  304.         ESC     The escape key is used to answer a user page.  It
  305.                 is also used to terminate CHAT mode.
  306.  
  307.  
  308. Epilog:
  309. =======
  310.  
  311. Please enjoy the program and feel free to contact Mycroft RBBS with any
  312. comments or questions:
  313.  
  314.                                                 Thanks,
  315.  
  316.                                                 Michael W. Bayley
  317.                                                 MYCROFT RBBS
  318.                                                 (408)927-0105
  319.  
  320.